home *** CD-ROM | disk | FTP | other *** search
/ BBS in a Box 15 / BBS in a box XV-2.iso / Files II / Art / Art Tools / Rotater 3.0 FAT.sit / Rotater 3.0 / README 3.0 / README 3.0
Encoding:
Text File  |  1995-05-27  |  8.0 KB  |  270 lines  |  [TEXT/ttxt]
  1. Rotater 3.0
  2. ===========
  3. This is a program that reads a set of 3-dimensional points
  4. and lines and plots them in a window. The image can then
  5. be rotated with the mouse in real time.
  6.  
  7. Requires System 7 or greater.
  8. 8 bit colour screen and Power Macintosh preferable.
  9.  
  10.  
  11. Versions
  12. --------
  13. Rotater-FAT-3.0
  14. A fat binary for PowerMacs and 68K Macs
  15.  
  16. Rotater-881-3.0
  17. A binary for 68K Macs with an FPU
  18. Will not run on a PowerMac or a 68K Mac with no FPU
  19.  
  20.  
  21. Changes from 2.0
  22. ----------------
  23. A new icon :-)
  24. faster!
  25. Can now have a white background in 3D-Glasses Mode.
  26. Recompiled with CW5 - slightly faster again.
  27. New folder icon :-)
  28. Floating Info Windows.
  29. New folder icon for rotater files :-)
  30. Can now center object on the screen
  31. Reads in large files more than 20 times faster
  32. Muchly speeded up (esp. small windows)
  33. Better default positions
  34. Better zooming of fast images
  35. Added Funky mode
  36. Can now set Max window size
  37. Optimum window sizing
  38. New rotation method
  39. Can set vector image resolution
  40. More speed again
  41. Newer icons
  42. Shows angles
  43. Can reset angles
  44. Fixed Vector Save file bug
  45.  
  46.  
  47. Help
  48. ----
  49. The program has balloon help for all of the menu items.
  50.  
  51.  
  52. Maximum Window Size
  53. -------------------
  54. You can now set the maximum window size that the program
  55. can use. This can be done by holding down the option key
  56. on startup. The selected size is saved for future sessions.
  57.  
  58. Larger windows require more memory to run so set the Max
  59. size to as small as possible if you need to conserve
  60. memory. You will also need to adjust the minimum and
  61. prefered memory sizes in Rotater's Get Info... box
  62. from the Finder.
  63.  
  64. If you cannot open the program because you have set the
  65. Max window size too high for available memory use the
  66. option key at startup to set a smaller window size.
  67.  
  68.  
  69. Rotation Method
  70. ---------------
  71. Click on the image and hold the mouse button down. Moving the
  72. mouse now rotates the image.
  73.  
  74. The track-ball rotation method is on by default.
  75. Imagine the image is inside a clear ball. Dragging the mouse
  76. across it is like rolling the ball. Try it and see :-)
  77.  
  78. Z-X rotation allows you to set the angle of looking at the
  79. object by moving the mouse up and down and the z-rotation
  80. by moving it left and right. This works best for things
  81. that have a natural up. Note the the up position is the
  82. current one when switching from trackball rotation. It
  83. can be reset to the original by using the reset angles
  84. command.
  85.  
  86. If you have the Grab & Spin option set under the action menu,
  87. when you let go of the mouse button while still moving the mouse
  88. the image will continue to rotate in the same direction.
  89. (or continue about the Z axis when using (Z-X rotation)
  90. Stop all rotation by clicking the mouse once. You may need to
  91. hold the mouse button down for a while on slow machines.
  92.  
  93. Drag & Spin will not work if the image takes longer than 1/4 of a
  94. second to calculate and draw. Copying to very large windows slows
  95. the program down considerably.
  96.  
  97.  
  98. Keyboard Rotations
  99. ------------------
  100. The "x", "y" and "z" keys rotate about their respective axes. By
  101. holding the shift key down when using them, the image will rotate
  102. in the opposite direction. The arrow keys can also be used for
  103. rotating the image.
  104.  
  105. The 'x' axis runs left and right across the window, 'z' runs up
  106. and down the screen and 'y' runs into and out of the screen.
  107.  
  108.  
  109. Showing Angles
  110. --------------
  111. The "show angles" option displays the current or last rotation
  112. vector when in Trackball Mode or the absolute rotation of the
  113. object when not in Trackball Mode. By switching to trackball
  114. mode the angles are zeroed. This can be used to realign the
  115. object.
  116.  
  117.  
  118. Resizing the Viewing Window
  119. ---------------------------
  120. The viewing window can be resized using an invisible handle on
  121. the bottom right corner of the window.
  122.  
  123. Maximum window size can be set by holding the option key
  124. down while launching the program.
  125.  
  126. Square windows are optimal in normal mode. Windows twice as
  127. wide as they are high are optimal for stereo mode.
  128. By clicking in the zoom box of the window with the option
  129. key held down the window will size itself optimally for
  130. the current mode setting.
  131.  
  132. Smaller windows run faster.
  133.  
  134.  
  135. Saving Images
  136. -------------
  137. Images can be saved to disk either as a 72 dot per inch
  138. bitmap or as Vector file that can be edited and
  139. printed from draw type programs. Note that there is an upper
  140. limit for the number of elements that can be saved in vector
  141. format somewhere around 20,000.
  142.  
  143. The default resolution for saved vectors is 300 dpi. This can
  144. be changed by holding down the option key when selecting the
  145. menu item. The new setting can be set as the default for
  146. future sessions by saving the preferences.
  147.  
  148. Note that files saved at high dpi have joins at 72dpi intervals
  149. when imported to some programs or ungrouped in others.
  150. I am not sure how to fix this.
  151.  
  152.  
  153. Maximum Number of Points/Lines
  154. ------------------------------
  155. The default memory allocation for the program should be enough to
  156. read about 20000 points or lines in. To increase this number,
  157. increase the memory allocation in the programs "Get Info" box.
  158.  
  159. You will receive a warning if you try to read in a file that is
  160. too large for available memory.
  161.  
  162.  
  163. Speed of Rotating
  164. -----------------
  165. Smaller windows run faster.
  166.  
  167. Hiding lines slows the program down especially on non-PPC machines.
  168.  
  169. Thinner lines and smaller dots run faster.
  170.  
  171. Make sure your monitor is in 8-bit mode with the System colour
  172. palette for maximum speed.
  173.  
  174. This program runs VERY VERY much faster on a Power Macintosh than
  175. on a 68K Macintosh (about 10 times faster!).
  176.  
  177. Points plot faster than lines. 20000 points can be
  178. comfortably manipulated on a Power Macintosh 6100/60.
  179.  
  180.  
  181. Format of the Input File
  182. ------------------------
  183. The input file consists of sets of four points on each line
  184.  
  185. x y z c
  186.  
  187. x = x coordinate of a point (real)
  188. y = y coordinate of a point (real)
  189. z = z coordinate of a point (real)
  190. c = colour and/or drawing method (integer)
  191.  
  192. if (c = 0) move to the x,y,z point without drawing
  193. if (c > 0) draw a line to the x,y,z point from the current
  194.            position using colour c
  195. if (c < 0) draw a dot at x,y,z using colour -c
  196.  
  197. where
  198. if (c = 1) colour is red
  199. if (c = 2) colour is green
  200. if (c = 3) colour is blue
  201. if (c = 4) colour is yellow
  202. if (c = 5) colour is purple
  203. if (c = 6) colour is cyan
  204. if (c > 6) colour is white
  205.  
  206. eg
  207. 0.5 2.3 -1 0  # moves to point 0.5 2.3 -1 without drawing
  208. 3 5 6 2       # draws red line from 0.05 2.3 -1 to 3 5 6
  209. 5 -5 2 -3     # plots blue dot at 5 -5 2
  210.  
  211. The points are automatically scaled to fit in the window and
  212. rotation is about 0,0,0.
  213.  
  214. The input file can be any text file.
  215. # Comment lines begin with the '#' character.
  216. Text after the four points on a line is ignored.
  217. Completely blank lines are ok (they are ignored).
  218.  
  219. Contiguous comments at the very start of the file are read in
  220. and displayed in the program in the Info window.
  221. Use this to explain to the user what the image is and where
  222. it comes from. Try to keep it short otherwise the window gets
  223. too big. Internal documentation can be placed in other
  224. comments after a blank line.
  225.  
  226.  
  227. Notes
  228. -----
  229. This program is free and I take no responsibility if it kills
  230. your machine or drives you mad. Use at your own risk.
  231.  
  232. It may not be sold.
  233.  
  234. Source code and project files for the Metrowerks CW5 compilers
  235. are available at the archive site or on request.
  236.  
  237. E-mail me if you find a use for this program or come up with a
  238. cool set of points/lines worth adding to the collection.
  239.  
  240. The official Archive site for source code, new updates,
  241. rotation files etc is:
  242.   ftp://raru.adelaide.edu.au/rotater/
  243. or
  244.   http://raru.adelaide.edu.au/rotater/
  245.  
  246.  
  247. Thanks To
  248. ---------
  249. Thanks go to the following:
  250.  
  251. Metrowerks for a great compiler.
  252. Toby Thain and Dale Greer for help speeding up the program.
  253. Andrew Maloney for speed and floating window help.
  254. Tim Olson for bzero.
  255. David Doak, Charles Williams and E.J. Chichilnisky
  256.  for many helpful suggestions.
  257. Richard Chipper for the new icons and the new new icons.
  258. Troy Gaul for the Infinity Windoid WDEF.
  259. Patrick Rabou for a number of optimisations.
  260. Brent Stone for heaps of cool speed optimizations.
  261.  
  262. Numerous people for rotation files (see comments in the files)
  263.  
  264.  
  265. Enjoy
  266.  
  267. Craig Kloeden
  268. craig@raru.adelaide.edu.au
  269. 27 May 1995
  270.